home *** CD-ROM | disk | FTP | other *** search
/ CU Amiga Super CD-ROM 27 / CU Amiga Magazine's Super CD-ROM 27 (1998)(EMAP Images)(GB)[!][issue 1998-10].iso / CUCD / PowerPC / vbcc / machines / amigawos / doc / extralib.doc next >
Text File  |  1998-08-02  |  3KB  |  75 lines
  1.  
  2. INTRODUCTION
  3.  
  4.     extra.lib is a link library for vbcc which contains certain often
  5.     used functions that are not standard ANSI-functions. It may e.g.
  6.     be helpful in porting programs.
  7.  
  8.  
  9. LEGAL
  10.  
  11.     The functions in extra.lib are written by Kasper B. Graversen and
  12.     Volker Barthelmann.
  13.     extra.lib is public domain.
  14.  
  15.  
  16. USAGE
  17.  
  18.     To link with extra.lib (or the small data version extras.lib) you
  19.     can either use vconfig (add 'extra' or 'extras' in the lib link
  20.     menu) or specify '-lextra' or '-lextras' to vc.
  21.     There is also a header file <extra.h>.
  22.  
  23.  
  24. FUNCTIONS
  25.  
  26.     At the moment extra.lib contains the following functions:
  27.  
  28.     getch()         Similar to getchar() but sets the console to raw mode
  29.                     and does not wait for return.
  30.  
  31.     stricmp()       Case-insensitive variant of strcmp(). Can be inlined
  32.                     by #defining __INLINE_STRICMP when including <extra.h>.
  33.  
  34.     strnicmp()      Case-insensitive variant of strncmp(). Can be inlined
  35.                     by #defining __INLINE_STRNICMP when including <extra.h>.
  36.  
  37.     chdir()         Changes the current directory.
  38.  
  39.     clock()         This is an alternative version of the clock() function
  40.                     in vc.lib. clock() is supposed to return the amount of
  41.                     cpu-time spent by the current program. As this is
  42.                     generally not possible on the Amiga clock() from
  43.                     vc.lib always returns -1.
  44.                     However there seem to be several badly written
  45.                     programs that do not check this. So this version
  46.                     of clock() returns values which are strictly ascending
  47.                     for successive calls to clock() and the difference
  48.                     between them is the time difference between the calls.
  49.  
  50.     iswhitespace()  Variant of isspace(). Can be inlined by #defining
  51.                     __INLINE_ISWHITESPACE when including <extra.h>.
  52.  
  53.     isseparator()   Tests for ',' or '|'. Can be inlined by #defining
  54.                     __INLINE_ISSEPARATOR when including <extra.h>.
  55.  
  56.  
  57. FUTURE
  58.  
  59.     If you are missing certain functions and would like them to be
  60.     included in extra.lib send a mail to Kasper B. Graversen at
  61.  
  62.         (internet)
  63.         kbg2001@internet.dk
  64.  
  65.         (fidonet)
  66.         2:237/30.7
  67.  
  68.     Please explain the desired functions as detailed as possible (how
  69.     they should work, prototypes, return values in case of errors etc.).
  70.     If possible submit source code for the function.
  71.  
  72.  
  73. Kasper B. Graversen and Volker Barthelmann
  74.  
  75.